home *** CD-ROM | disk | FTP | other *** search
/ Resource Library: Multimedia / Resource Library: Multimedia.iso / maestro / docmnttn / installt.txt < prev    next >
Encoding:
Text File  |  1993-06-15  |  8.5 KB  |  221 lines
  1. Installation Guide for the MAEstro Multimedia Authoring Environment
  2.  
  3. Last modification: February 8, 1993
  4.  
  5. I.    Introduction
  6.  
  7. The purpose of this document is to help you install the MAEstro
  8. release.  Installation should take about 30 to 45 minutes if
  9. everything goes well.
  10.  
  11. If you have any questions about the installation process or about
  12. MAEstro in general, please send mail to
  13.  
  14.         maestro@sioux.stanford.edu
  15.  
  16.  
  17.  
  18. II.    Before You Start
  19.  
  20. MAEstro requires a few key pieces of software.  If you do not have
  21. the following software, please contact your system administrator about
  22. getting them for your computer:
  23.  
  24. * ANSI-C compiler (gcc recommended; MAEstro was developed with gcc,
  25.   the GNU C Compiler).  You can obtain gcc via anonymous ftp from
  26.   prep.ai.mit.edu.  Ask your system administrator for details.
  27.   We have also successfully compiled the MAEstro source with the "acc"
  28.   Sun ANSI-C compiler.
  29.  
  30. * XView libraries.  If your system has installed OpenWindows 2.0 or
  31.   later, you already have the XView libraries.  If not, you can get
  32.   the XView toolkit libraries by installing OpenWindows (available
  33.   from Sun) or you can get the XView source code via anonymous ftp
  34.   from export.lcs.mit.edu.  Ask your system administrator for details.
  35.   Note: this version of the MAEstro release was built with the
  36.   XView 3.0 toolkit.  If you are using XView 2.0 (or OpenWindows 2.0),
  37.   you should switch to version 3.0 of either XView or OpenWindows
  38.   as soon as possible.
  39.  
  40. * (optional) TIFF & JPEG image libraries.  The DisplayTool application
  41.   requires the use of these libraries.  If you don't have this
  42.   software, you can either obtain and compile the TIFF and JPEG
  43.   libraries, or you can remove the "DisplayTool" entry from the master
  44.   Makefile's "SubDirs" definition, so that DisplayTool does not
  45.   compile.
  46.   These libraries are available from a number of Internet source code
  47.   archives and vendors of publicly-available source code CD-ROM's
  48.   (such as Prime Time Freeware).  For example, you can obtain the TIFF
  49.   library code via anonymous ftp from export.lcs.mit.edu (in the
  50.   /contrib section), and you can obtain the JPEG source code via
  51.   anonymous ftp from ftp.uu.net in the directory /graphics/jpeg.
  52.  
  53.   Ask a system administrator for details.
  54.  
  55. Note: As of this release, you no longer need the DevGUIDE application
  56. builder.  If you have DevGUIDE, great.  If not, you will need to
  57. compile the GUIDE libraries yourself before compiling the MAEstro
  58. applications.
  59.  
  60. Please see the end of this document, Appendix I for details on how to
  61. build and install the GUIDE libraries yourself.
  62.  
  63.  
  64. III.    Preparing the Installation
  65.  
  66. * Go to the MAEstro distribution's Source directory and make a copy of
  67.   the file "Makefile", in case you have to start from a fresh copy of
  68.   the Makefile later.
  69.  
  70. * Modify the following Makefile variables as follows:
  71.  
  72.     - SourceDir: this indicates the location of the top of the
  73.       MAEstro source tree.  For example, if you unpacked the
  74.       MAEstro distribution into "/home/MAEstro", SourceDir should
  75.       be set to "/home/MAEstro/Source".
  76.  
  77.     - DestDir: the directory into which the applications will be
  78.       installed.  Make sure this directory exists before
  79.       installing MAEstro.
  80.  
  81.     - InstallFlags: determines whether debugging information
  82.       should be stripped from the installed applications.  If the
  83.       debugging information is retained, errors are easier to
  84.       report but the applications consume more memory.  If the
  85.       debugging information is stripped, the applications occupy
  86.       less space but error reporting will be more difficult.  The
  87.       default is to strip the debugging information, reducing the
  88.       space used by the applications.
  89.  
  90.     - AudioLibDir: determines where the Sun audio header files
  91.       and libraries are installed.  You should not normally need
  92.       to modify this variable.
  93.  
  94.     - FrameRate: variable used by the VideoObject and all MAEstro
  95.       applications that use the VideoObject.  This determines the
  96.       frame rate at which your video devices operate.  Currently
  97.       there are two standard choices provided by the Makefile:
  98.       NTSCFrameRate (30 frames per second) and PALFrameRate (25
  99.       frames per second).  You are welcome to supply your own
  100.       value for FrameRate if the devices you use operate with yet
  101.       another frame rate.
  102.  
  103.     - VideoFrameApp: determines whether to attempt compilation of
  104.       the "VideoFrame" application.  If you have the XVideo
  105.       board from Parallax Graphics, you should use the first
  106.       definition supplied by the Makefile (by default it is
  107.       commented out).  If you don't have the hardware, leave the
  108.       default definition intact.
  109.  
  110.  
  111. IV.    Building the Release
  112.  
  113. * If you have not already done so, define the following environment
  114.   variables:
  115.  
  116.     - OPENWINHOME: If you have OpenWindows, this variable points
  117.       to the directory in which OpenWindows was installed.  On
  118.       many Sun systems, it is usually set to "/usr/openwin".
  119.       If you are using the XView toolkit without OpenWindows, then
  120.       set this variable to the place that contains the XView
  121.       libraries and header files.  For example, on our machines we
  122.       have installed the XView headers in "/usr/local/X/include"
  123.       and the XView libraries in "/usr/local/X/lib", so we would
  124.       set OPENWINHOME to "/usr/local/X".
  125.  
  126.     - GUIDEHOME: If you have Sun's DevGUIDE, this variable points
  127.       to the directory in which DevGUIDE was installed.  On our
  128.       machines, this variable is set to "/usr/local/DevGUIDE3.0".
  129.       If you do not have DevGUIDE and have thus built the GUIDE
  130.       libraries yourself from the unsupported code provided by
  131.       this distribution (see Appendix I at end for more
  132.       information), then you should set GUIDEHOME to the place
  133.       you installed the GUIDE libraries and headers.
  134.  
  135. * In SourceDir, type "make".  If all goes well, you will see a number
  136. of messages from the compiler, and finally a message that says:
  137.  
  138.     Build of MAEstro is complete.
  139.  
  140. * Make sure that the directory specified by DestDir exists.
  141.  
  142. * Type "make install".  If the installation is successful, you will
  143. see a message that says:
  144.  
  145.     Installation of MAEstro applications is complete.
  146.  
  147.  
  148. V.    Testing the Release
  149.  
  150. * Make sure that the directory specified by DestDir is in your path.
  151.   Then, type "rehash".
  152.  
  153. * Make sure that you are running either the OpenWindows or X11 window
  154.   system.
  155.  
  156. * Launch the TimeLine authoring application as follows:
  157.  
  158.     TimeLine /tmp/MAEstro/TestInstall &
  159.  
  160.   If successful, TimeLine will launch the Digital Tape Recorder and
  161.   QuoteMaker applications then "iconify" them.
  162.  
  163. * Press the Play button on TimeLine (the button with the picture of
  164.   the arrow on it).  If you hear and see a greeting, the installation
  165.   of the MAEstro application suite was successful.
  166.  
  167.  
  168. Appendix I.    Building the GUIDE Libraries
  169.  
  170. This release of the MAEstro distribution includes the source code for
  171. the two GUIDE libraries needed to compile the XView-based MAEstro
  172. applications.  The source is split across two libraries, and thus two
  173. directories.  For this discussion, assume that you have installed the
  174. MAEstro source in the directory "/MAEstro".  In this case, the two
  175. directories you'll need to look at are:
  176.  
  177.     1) /MAEstro/Source/unsupported/Guide/src/libguide
  178.     2) /MAEstro/Source/unsupported/Guide/src/libguidexv
  179.  
  180. (IMPORTANT: The source for the GUIDE libraries is redistributed from
  181. Sun Microsystems source, and is subject to Sun's copyright notices,
  182. which are in the source code.  If you are even thinking about
  183. redistributing any part of MAEstro, please read the Sun copyright
  184. information first.)
  185.  
  186.  
  187. Here is what you need to do:
  188.  
  189. * Set the environment variable "GUIDEHOME" to the following:
  190.  
  191.     /MAEstro/Source/unsupported/Guide
  192.  
  193. * If you have not already set the environment variable "OPENWINHOME",
  194.   please do so now, according to the instructions given earlier in
  195.   this document.
  196.  
  197. * Next, cd to the first directory listed above and type "make".  This
  198.   should build the library file "libguide.a" without any problems.
  199.  
  200. * Type "make install".  This should install the necessary library and
  201.   header files in the correct place.
  202.  
  203. * Now, cd to the second directory listed above and type "make".  This
  204.   should build the library file "libguidexv.a" without any problems.
  205.  
  206. * Type "make install" for this directory.  Again, this should install
  207.   the necessary library and header files in the correct place.
  208.  
  209. At this point, you should have built the DevGUIDE libraries correctly.
  210. To check, see that the files "libguide.a" and "libguidexv.a" are in
  211. the directory
  212.  
  213.     /MAEstro/Source/unsupported/Guide/lib
  214.  
  215. and that there are some header files (*.h) in the directory
  216.  
  217.     /MAEstro/Source/unsupported/Guide/include
  218.  
  219. You are now ready to continue with the rest of the MAEstro
  220. installation process.
  221.